package com.bcu.cn.onlineexamsystem.studentmanage.service;

import com.bcu.cn.onlineexamsystem.studentmanage.controller.ScoreAnalysisDTO;

import java.util.List;
import java.util.Map;

/**
 * 成绩分析服务接口
 */
public interface ScoreAnalysisService {
    
    /**
     * 获取学生成绩统计信息
     */
    ScoreAnalysisDTO.ScoreStatistics getScoreStatistics(String studentId);
    
    /**
     * 获取学生所有考试记录
     */
    List<ScoreAnalysisDTO.ExamRecord> getStudentExamRecords(String studentId);
    
    /**
     * 获取各课程成绩分析
     */
    List<ScoreAnalysisDTO.CourseScoreAnalysis> getCourseScoreAnalysis(String studentId);
    
    /**
     * 获取成绩趋势数据
     */
    ScoreAnalysisDTO.ScoreTrend getScoreTrend(String studentId);
    
    /**
     * 获取成绩分布数据
     */
    ScoreAnalysisDTO.ScoreDistribution getScoreDistribution(String studentId);
    
    /**
     * 获取最近考试记录
     */
    List<Map<String, Object>> getRecentExamRecords(String studentId, Integer limit);
    
    /**
     * 获取指定考试的成绩详情
     */
    Map<String, Object> getExamScoreDetail(String studentId, Long examId);
    
    /**
     * 获取班级排名信息
     */
    Long getClassRank(String studentId, Long examId);
    
    /**
     * 获取班级平均分
     */
    Double getClassAverage(String studentId, Long examId);

    /**
     * AI智能对话
     */
    String askAI(String studentId, String question);

    /**
     * AI自动学习建议
     */
    String askAISuggestion(String studentId);
} 